.TH std::jthread::detach 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::jthread::detach \- std::jthread::detach

.SH Synopsis
   void detach();  \fI(since C++20)\fP

   Separates the thread of execution from the jthread object, allowing execution to
   continue independently. Any allocated resources will be freed once the thread exits.

   After calling detach *this no longer owns any thread.

.SH Parameters

   \fI(none)\fP

.SH Return value

   \fI(none)\fP

.SH Postconditions

   joinable is false.

.SH Exceptions

   std::system_error if joinable() == false or an error occurs.

.SH Example


// Run this code

 #include <chrono>
 #include <iostream>
 #include <thread>

 void independentThread()
 {
     std::cout << "Starting concurrent thread.\\n";
     std::this_thread::sleep_for(std::chrono::seconds(2));
     std::cout << "Exiting concurrent thread.\\n";
 }

 void threadCaller()
 {
     std::cout << "Starting thread caller.\\n";
     std::jthread t(independentThread);
     t.detach();
     std::this_thread::sleep_for(std::chrono::seconds(1));
     std::cout << "Exiting thread caller.\\n";
 }

 int main()
 {
     threadCaller();
     std::this_thread::sleep_for(std::chrono::seconds(5));
 }

.SH Possible output:

 Starting thread caller.
 Starting concurrent thread.
 Exiting thread caller.
 Exiting concurrent thread.

.SH References

     * C++23 standard (ISO/IEC 14882:2023):

     * 33.4.4.3 Members [thread.jthread.mem]
     * C++20 standard (ISO/IEC 14882:2020):

     * 32.4.3.2 Members [thread.jthread.mem]

.SH See also

   join     waits for the thread to finish its execution
            \fI(public member function)\fP
            checks whether the thread is joinable, i.e. potentially running in parallel
   joinable context
            \fI(public member function)\fP
   C documentation for
   thrd_detach
